Cache Control
Disk Cache Control for AWeb.
By William H. M. Parker bill@amitrix.com

26 Sep 1999 - Free Ware


Index

Installation

The files CacheControl_Doc.html and CacheControl.awebrx belong in 'AWeb3:plugins/'. Cache Control will actually work anywhere as long as both of its files are kept in the same drawer.

AWNPipe-handler should be in L:. Both AWNPipe and AWNPipe.info should be in Devs:DOSDrivers. You might need to reboot after updating the pipe handler.

The CacheControl.awebrx script may be called directly from the ARexx menu, from an AWeb GUI Button, or a KeyBoard shortcut .

GUI Button 

name            CacheCtrl
command         run aweb3:plugins/CacheCtrl.awebrx
ARexx Menu
title           Cache Control
macro           aweb3:plugins/CacheCtrl.awebrx
KeyBoard Shortcut
Key             ALT C
command         run aweb3:plugins/CacheCtrl.awebrx %u

If you don't use an Aweb3: assign you must use 

                FullPath/CacheCtrl.awebrx
ARexx limits file name length so the use of the assign is preferred.

How does it work ?

The Cache Control GUI is built directly from ARexx using AWNPipe:.

This script controls the cache by adding DO NOT CACHE entries that use pattern matching. Maintenance is performed by either building a delete list with the list commands 'upto' option, or by changing AWebs disk cache size to force flushing of files.

Using the Disk Cache Control Script

Simply click the GUI button, call from the ARexx Menu, or use the KeyBoard Shortcut to run the CacheControl.awebrx script. This causes a requester to open on AWebs screen.

To make the best use of the disk cache it is suggested you read docs/cache.html.

Control Page

The Global settings at the top effect the caching of all sites you visit.

Full Caching On
Do Not Cache images
Cache Only Images
Disable All Caching
These setting are pretty much self explanatory.

The This site settings only control the caching of the site shown in the chooser. The chooser allows you to determine the matchable text used to specify the site. It also contains a '*Show All Setting*' option to allow you to review all of your Do Not Cache settings.

The small button to the left of the chooser will cause the Cache Control script to read AWebs current URL and regenerate the chooser options.

Full Caching On
Do Not Cache images
Cache Only Images
Disable All Caching
These setting are still pretty much self explanatory.

The current settings list at the bottom of the control page shows the Cache settings that control the site displayed in the this site chooser. You can select a setting in the list by clicking on it.

Edit - This button opens a requester to let you edit the selected setting.

Remove - This button deletes the selected setting.

New - This button opens a requester to let you manually enter a setting.

Save - This button saves the cache settings and makes them permanent. If you do not save the settings after changing them they will be lost when you reboot your computer.

Maintenance Page

The maintenance functions allow you to selectively delete files from AWebs cache.

To remove files based on their age, set the maximum number of days you want files kept and click 'Expire Cache Files' .

You can also force AWeb remove a specific amount of the files in the cache. Set the percentage of the files you wish kept and click the 'Reduce Cache Level' button.

You should not quit AWeb or reboot your computer while the maintenance functions are in process.

Menus

Snapshot / Unsnapshot - These determine if Cache Controls size , position, Number of days, and percent settings are remembered.

Cache Control Docs - Load this documentation in AWeb.

Information - Displays information about your version of Cache Control.

Quit - Quit the Cache Control Script.